home *** CD-ROM | disk | FTP | other *** search
-
-
-
-
-
- ‹€€€€€€‹ ‹€€€€€€ ‹€€€€€€‹ ‹€€€€€‹ €€€€€€‹ fi€€› €€€€€€€ ‹€€€€€€
- €€ €€ €€ €€‹‹‹‹ €€ €€ €€ €€ €€ €€ €€ €€ ‹€€fl €€‹‹‹‹
- €€ €€ €€ €€flflflfl €€ €€ €€ €€ €€ €€€€€€ €€ ‹€€fl €€flflflfl
- €€ €€ €€ fl€€€€€€ €€ €€ €€ fl€€€€€fl €€ fl€€ fi€€› €€€€€€€ fl€€€€€€
-
-
-
-
-
- Version 2.00
-
-
-
-
- (c) 1993 by David Gurecki
-
-
-
-
- Disclaimer
- ==================
-
- The author of this program is in no way responsible for any damage, either
- software or hardware, which may result as a use of this program. Use at
- your own risk.
-
-
-
- Note to Readers
- =======================
-
- This version of Memorize still may have some bugs in it. It has been beta-
- tested on a few machines, but unexpected results may yet occur. I have
- attempted to get it working the best I could, but I cannot predict everything.
- If you encounter an error which occurs consistently, please send mail to
- the addresses listed below and describe to me the problem, so that I may
- make provisions to fix it in upcoming versions.
-
-
-
- Introduction
- ====================
-
- Memorize is a program to aid students in studying for quizes and tests.
- Being a student is not easy, especially in Junior High, High School, and
- College. There's always have a test or a quiz coming up, and many students
- either drive themselves crazy trying to study, or just don't study at all.
- Now, there's an easier solution...
- Memorize, very simply, is a program which asks you a question, and allows
- you to type in an answer. Just give the program a list of questions and
- answers, and you can quiz yourself over and over again until you know the
- answer to each question. The program keeps score of how many questions you
- answer correctly and incorrectly, so you can watch your score improve each
- time you go through a quiz. It can also randomize the question order, swap
- the questions and answers (i.e., ask you the answer, and you have to type in
- the question), and keep track of the time it takes to complete a quiz. For
- those who register, the program also will count a question correct if you only
- have part of the answer (partial credit). This is useful if you are a bad
- speller, or don't know the entire answer, but know enough to be correct.
- Memorize can be used for Foreign Language vocabulary, basic facts/trivia,
- and memorizing phone numbers, names, dates, places, words, or anything else.
- It can be used for anything that requires memorization of two items. Using
- Memorize to study repeatedly may actually help you save time studying for
- tests, and time is a very valuable thing for students. If you can get a score
- of 100 three or four times in a row with Memorize, you definately know the
- words, and are fully prepared for whatever quiz or test you have to take. You
- cannot and should not study for *every* test with Memorize. But the ones you
- can and do use Memorize for, you will find come a lot easier.
-
-
-
- How To Use It
- =====================
-
- 1. Program Syntax
- -----------------
- When you type Memorize without command line parameters, this is what is
- displayed:
-
-
- ** Memorize 2.00 **
-
- Usage: memorize [file1] [file2] ... [file8]
- memorize [config.cfg] [file1] [file2] ... [file7]
-
- Where:
- [file1]...[file8] are files containing quiz data,
- [config.cfg] is any config file ending in ".cfg".
-
-
- On the command line, you may specify either one or more word files, a config
- file, or a config file AND one or more word files. (Both are described below.)
- All these files must be in the same directory as the Memorize program itself.
- It is recommended you make a separate directory, into which you place Memorize,
- and all the files you will use with it. If you specify a config file, it must
- end in ".cfg", AND be the first file after the word Memorize. Also, please see
- the section about Word File restrictions.
-
-
- 2. The Word Files
- -----------------
- The first thing to do is create a word file. This is a file containing all
- the questions and their corresponding answers. Memorize reads this file to
- determine what questions to ask you, and what answers you should be typing in.
- The format is as follows: Question 1 on the first line, answer to question 1
- on the second line. Question 2 on the third line, answer to question 2 on the
- fourth line...etc.
-
- Here is an example...
- ===================
- Line 1: What is the capital of New York?
- Line 2: Albany
- Line 3: Who is buried in Grants Tomb?
- Line 4: Grant
- Line 5: When was the war of 1812?
- Line 6: 1812
- ===================
-
- Here is an example of a Spanish vocab file...
- ===================
- uno
- one
- adios
- goodbye
- hola
- hello
- ===================
-
- (NOTE: In the first example, Line 1, Line 2, etc. is shown to indicate the
- line numbers. These would not be present in an actual file, as in the second
- example.)
-
- Word File RESTRICTIONS:
- -----------------------
- In creating your Word Files, please remember the following restrictions:
-
- - ALL files specified must be in the same directory as the
- Memorize.exe program; you cannot specify a path along with the
- file name.
- - You can specify up to 10 files to be used as word files. No more
- than 10 files *total* can be specified in a config file (see
- below) and on the command line.
- - All the files cannot have a combined length of more than 500 lines.
- Similarly, no individual file can be more than 500 lines.
- - The length of each line should not be more than 70 characters long.
- - Do not leave any blank lines in the file. This WILL cause an error.
- - The file should have an even number of lines. An odd number will result
- in the last line being truncated.
-
- If any of these conditions should occur, an error message will be displayed,
- and the particular file may be excluded. If there is a problem with every
- file you specified, the program will exit, since it has no quiz data to
- process.
-
-
- 2. The Configuration File
- -------------------------
- Memorize has a few options that can be configured from within the program.
- If use the same settings over and over, you now have the ability to specify
- those in a config file. You can also specify one or more Word Files in the
- config file. Here is the format. (Default values are shown).
-
- ==============
- 0 < Randomize Questions Option 1 = ON, 0 = OFF
- 0 < Switch questions/answers 1 = ON, 0 = OFF
- 0 < Case Sensitivity 1 = ON, 0 = OFF
- 0 < Time quiz sessions 1 = ON, 0 = OFF
- 50 < Partial Credit percentage*
- [file1] < Up to 10 Word Files (optional)
- [file2] .
- [file3] .
- . .
- . .
- [file10] <-'
- ==============
-
- "Randomize Questions" will cause the program to ask the questions in a random
- order if ON, and in the order as they occur in the file if OFF.
-
- "Switch questions/answers" causes the program to ask what would normally be the
- answer, and use the question as what the user has to type in when ON. (i.e.,
- Line 1 would become the answer, and Line 2 would become the question, etc.)
- This is useful if you know some words from Spanish to English, and want to
- study them from English to Spanish. A setting of OFF treats the questions and
- answers as they normally are.
-
- "Case Sensitivity" will treat a capital "A" and a small "a" in a response as
- different letters if set to ON, and will treat them as the same letter if set
- to OFF.
-
- "Time Quiz Sessions" will report the elapsed time of a quiz session when it is
- done, along with displaying your score for that quiz, if set to ON. If set to
- OFF, it will only display your score.
-
- "Partial Credit percentage" is the percentage of the correct answer you must
- get in order for the answer to be counted as a correct response. A value of
- "50" means half the word, "75" would be 3/4 of the word, etc. For example, if
- the correct answer is "memorize" and you type "memo", you would get credit for
- that question, since you got 4 out of 8 letters, or 50%, correct. You would
- also get the same credit if you typed "emor", "mori", "oriz", "rize", or more
- than 4 correct letters. A value of "0" disables partial credit checking.
-
- =================================================================
- How it works: The program checks pairs of letters to the correct answer. If
- the answer was "memo", the program would first see if me was in the correct
- answer. It then would check for "em", and then "mo". The number of letters
- found in the answer as a result of this process is divided with the total
- number of letters in the correct answer to determine a percentage. If that
- percentage is equal to or higher than the amount you specify, it will consider
- that question correct.
- ==================================================================
-
- ** NOTE: This option is available only to REGISTERED users. See below for
- information on how to Register. **
-
- Specifying Word Files in the Config File
- ----------------------------------------
- Finally, you may optionally specify up to 10 files in the config file to be
- used as Word Files (see the section describing Word Files for the format).
- The program will read these files BEFORE any specified on the command line
- after the config file. They are also held by the same restrictions as any
- Word File. If you have, for example, 7 Word Files listed in a config file,
- you may have no more than 3 on the command line, because there can only be
- a total of 10 Word Files. You can leave these blank, and have the Partial
- Credit value the last line of your configuration file. However, you will
- HAVE to specify Word Files on the command line in this case, since Memorize
- has no other specified Word Files.
-
-
- 4. The Program
- --------------
- Once you have created your Word File(s) or Config File, you are ready to run
- the program. When it first loads, it checks each file to make sure it is
- within the guidelines. The program also reads in any config file's options at
- this point. If any errors do occur, they will be displayed, so that you will
- be informed as to why a file is not included. The program then pauses whether
- there were any errors of not, to give you a chance to see them.
- The program then asks you if you would like color. NOTE: Memorize no longer
- uses ANSI codes to display color, so you do not need to load it in CONFIG.SYS
- as you have had to in the past. Still, it gives you the option for color or
- not.
- Then, the Title screen is displayed, as well as if the program is registered
- or not. When you register, your name will appear on the title screen. From
- here, you can either choose to (C)onfigure, (B)egin, or (Q)uit...
- Choosing 'B' will start the quiz with either the default settings, or the
- settings loaded from a config file, if you specified one. Choosing 'Q' will
- cause the program to exit.
- Choosing 'C' will allow you to change any of the program options (described
- in the "Config File" section), and displays to you the list of files, their
- lengths, and some other information. You can toggle any of the options by
- pressing their highlighted (or parenthesised) letters, and change the Partial
- Credit percentage value. You can also exit the program by pressing 'Q'. Once
- you have configured the options to your liking, press ENTER to begin the quiz.
-
- The Quiz
- --------
- The questions are displayed one by one, and you have to type the appropriate
- response at the "?" prompt. At the top of the screen, the current and total
- question numbers are displayed. Note that, when you are answering the
- questions, you can exit the program by pressing CTRL-C, and ENTER. A little
- heart character will appear, but the program will recognize that you pressed
- Control-C once you have pressed ENTER. If you have case sensitivity set to ON,
- you will have to type your response EXACTLY the same as the correct answer. If
- it is OFF, case will not matter, and you can type a capital where a lower-case
- letter should be, etc. If you have partial credit set to "ON" (and are
- registered), the program will highlight the letters in both the question and
- the answer which match. If you disable partial credit, or have an unregistered
- copy, then the program will display the correct answer below what you typed if
- you are wrong, and a "Correct!" message if you are right. You will then be
- prompted to press ENTER before going to the next question. After you answer
- the final question, you will be shown a count of how many you got right, how
- many you got wrong, and what your percentage correct is. If you specified the
- option of Timing the quiz session, the program will also display the elapsed
- time from when it displayed the first question, to when you pressed ENTER after
- the last question. From here, you will be given the opportunity to go through
- the quiz again, or exit the program.
-
-
- * SHAREWARE *
- =================
-
- Version 2.00 of Memorize is released as Shareware. For the few who might
- be unfamiliar with it, and for those who've forgotten what it is, Shareware
- means that you can use the program for a trial period, and then if you
- continue using it, must Register your copy with the Author. For Memorize,
- I would ask for a mere $5 when you Register, if you appreciate and use this
- program. It is just like buying some expensive game at a software store, except
- that you get it from a BBS, and it is not expensive.
- Many authors put time delays, beeps and bells, and many nag messages to get
- you to register. You'll find none of these in Memorize, aside from a single
- message in the Configuration screen reminding you to register. As an incentive
- to register, you will be able to use the Partial Credit feature described
- above. Please remember, though, you are paying for the use of the whole
- program, not just for the Partial Credit feature.
- Once you do decide to register, you will be sent instructions on how to set
- up the program to recognize that you have Registered. Your name will then
- appear every time you load the program, recognizing that it is YOUR copy. By
- registering, you will be entitled to a Registered copy of Version 2.00 and the
- next official release. You will be notified in the mail when the next version
- is released. You are the owner of that copy and only that copy, and you may
- not give it to anyone else. You may, however, freely distribute the MEM200
- archive, and you are encouraged to do so. Print out "register.doc", and fill
- out the form to register. You will be sent the means by which to register in
- the mail.
- One last note... Previous versions have been released as Public Domain. You
- do not and will never have to pay for the either of those versions. However,
- if you want access to some of the more advanced features, then you will want
- to get 2.00, which IS Shareware.
-
-
- Note from the Author
- ====================
-
- Memorize started out as a simple program for myself to help me study and
- review vocabulary for quizzes. I then got the idea to distribute it and give
- everyone else the opportunity to study for tests using their computer. I
- gave it to a few boards, releasing it as Public Domain. I would never have
- imagined the response I would get. People sent me mail about how they could
- study for school using Memorize, as well as other things, including memorizing
- telephone numbers, BBS names, etc. I also got many suggestions on how to
- enhance the program, and improve its cabilities. All of this positive
- response prompted me to continue its development.
- And before long, I released version 1.5, and got still more feedback on how
- to improve te program. So, here it is.. Version 2.00. I've tried to get
- out as many of the bugs as I could, but there's always the possibility of
- discovering new ones. As before, I greatly appreciate any comments, feedback,
- and suggestions on how to improve! And, remember, it's now Shareware, so I hope
- you'll register if you get a lot of use out of it, and feel that the weeks of
- hard work to help you do better in school might just be worth a measley $5...
-
-
- ** Enjoy the program! **
-
- David Gurecki,
- Author of Memorize
-
- Mail Addresses:
- ---------------
- Internet Addresses: gurecki@erda.rl.af.mil
- david.gurecki@f2.n2609.z1.fidonet.org
-
- Fido-Net: David Gurecki @ 1:2609/2
- Mirror Image @ 1:260/513
-
-
-
- Special Thanks to:
- ==================
- Dan Peck, for his continuing assistance and sharing of his vast C programming
- knowledge. Thanks!
- Eric Hayduk, for Betatesting, motivational support, and ideas about
- registration code process. Thanks!
- Adam Hutchinson, for motivational support, continuing suggestions, and for
- suggesting to release as Shareware. Thanks!
-
- And, ESPECIALLY, to ALL those people who have written E-Mail and contributed
- suggestions to me about Memorize. You guys are the ones who made this possible.
-